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are urged to send their names in to the editor. 
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NOTES FROM THE EDITOR 

This is a continuation of the August issue,' The index, for , 
this issue is contained in that issue. The entire issue was 
ready in July; however when I gave DECUS a 74-page issue, 
they told me that the TECO-SIG was only budgeted for two ; 

4 0-page issues a year. Consequently, I decided to split ; 

the issue up into two parts. Since the 'year' ends around June, 
this means that this will be the last issue "you "see .for 6 ? 
months unless we can get our budget changed. We'll talk about 
this problem at the SIG meeting in San Diego. Part of the 
problem is that we had no chairman at the. .time of budgeting; 
so DECUS assumed the number of issues we wanted 'this year 
would be the same as the number we published the previous year. 
We wouldn't be in this problem if we had a strong leadership. 
Also, I was given the option of reducing the text 50% (thus 
printing two pages on one side of a sheet). That would ^ have 
allowed us to publish another two issues. However, I did not 
like the looks of other newsletters that have done such a 
photor eduction; so without a steering committee to discuss 
such policy, I made the decision on my own not to go to half 
size. If you want more to say on . such topics, volunteer to 
be on the SIG's steering committee. 

This is the only page in this newsletter to be typed in 
November; the rest was typed in June. As of November 1, TECO-11 
and TECO-10 are still not in the DECUS library. I don't know 
what the problem is; both have been done and working for over 

5 months now. In any case, copies will be down at the symposium 
(I will hand carry them there if no one else does) . 

Only two solutions submitted so far for the current problem of the 
Month (the macro that locates itself) . Deadline is not yet up 
though. 

The symposium itself looks pretty good for TECO people. We have 
a lot of interesting stuff. There are a few errors in the 
official program; but nothing serious. The introductory TECO 
tutorial will be given by Pat Hall and J. Hayes. All the TECO 
tutorials this year are being well-prepared in advance. They 
should all be good - not our usual last-minute affairs.- We were 
supposed to have two EMACS tutorials. The SIG wanted this very 
much - we believe EMACS to be the up-and-coming great new concept. 
As of November 1, I have not heard from DECUS why these tutorials 
did not make it into the program. If possible, I would hope to 
still get them scheduled (as birds of a feather session if 
necessary). The SIG business meeting will also be a TECO roadmap 
session; so be there to here about any changes in the schedule. 
Because meeting rooms are suppose to be locked up at 11 PM, 
DECUS would not let. me officially schedule a TECO night owls of 
a feather session for midnight Thursday night; but I hope to still 
hold, the session either in our campground (if it's open) or in my 
hotel room. 

- Stan - 



OVERVIEW OF EMACS by ri chard m stallman Page 4a 

EMACS is a display editor. This means, first of all, that you see 
the result of each command as soon as you have finished typing it. Ue 
try to make this true of the smallest possible units of typing. So, 
for example, there is no "insert" command: to insert a character, you 
just type it, if it is a printing character (there is a command to 
quote other characters). As soon as you have typed it, it appears on 
the screen in the right place. If you make a mistake, just type 
Rubout, and the character before the cursor will disappear. Other 
commands uill move backward or forward over characters, up or down 
lines or to the beginning or end of the current line, to the beginning 
or end of the buffer, etc. This much applies to all display editors. 

Any display edi tor at all provides a tremedous advantage to the user 
over printing-terminal editors. Most users of display editors (EMACS, 
TVEDIT, Stanford ETV) find that they no longer need to make paper 
listings. Also, it becomes very easy to compose new programs on line. 

However, EMACS offers the additional feature of self-documentation. 
Not only are there the obvious commands which ask what a given 
character does; there is the command- "Apropos" which can tell you 
about all commands which have a given string in their names. If you 
have forgotten how to read in a file, just do *X Apropbs^Fi le. This 
will tell you about all commands whose names contain "File", one of 
which will be the one you seek. Additionally, there is an EMACS 
subsystem which is used for perusing tree-structured documentation 
files. It is called INFO; one way of entering it is to type "?" when 
EMACS starts up. INFO offers a tutorial on how to use INFO, 33 well 
as documentation on EMACS and whatever else you care to add to the 
tree. 

What distinguishes EMACS from all other display editors is that it 
is conveniently programmable: it contains an interpreter for a 
powerful programming language (called TECO, but much more suitable for 
system programming than DEC TECO. See the appendix). This makes it 
very easy for new commands to be written. An individual user can add 
a few commands of his own, or an ambitious person can write a sharabie 
library of useful commands which everyone can use. True, since any 
editor is a program, if you have the source you can modify it, but in 
practice a much greater sophistication is possible in EMACS programs 
than in assembler- language modifications to TECO. 

For example, you can program EMACS to understand the syntax of your 
favorite programming language. At MIT we have found useful commands 
for editing Assembler language, text (and input to text justifiers). 
Lisp, TECO code (for EMACS), and PL/1. The user can select a "major 
mode" such as "Text Mode", "Lisp Mode", etc., and each mode redefines 
a few commands to be appropriate to the language (a user or site. can 
add new major modes). In addition, there are several comment 
manipulation commands which can be U3ed for any language, because the 
major mode tells them wjpat strings are U3ed to begin and end comments 
in the language you are using. 

In "MIDAS Mode" (our assembler is called MIDAS), there are commands 
for moving to the next or the previous label, and for moving to the AC 
field or address field of an instruction. For Lisp, we have commands 
which indent code according to its nesting, which move over or up and 
down in list structure, which go to the beginning or end of the 
function you are working on, etc. For PL/1, there is a very hairy 
indentation program which figures what sort of statement or compound 
statement you are in the middle of and indents the line appropriately. 
The techniques used for PL/1 can easily be adapted to most other 
a I go I - 1 i ke I anguages. 



For Hdltina text, we have commands that understand eentencea, 
P * 9e " pa r nl,, as .el. as commando to till and Juo jfW -t. 
S..o? tnere is "Auto Fill" mode In*.* J™™,' *° * '* J« g 
broken when you type space, to fit a specitieo margin. * J . 

auto fill mode now. For text justifiers, we have commands to insert 
and de.ele "he text justifier commands that specify font selection and 
under lining. 

To save the user from having to select the right "Jf » od * J* ^^ 
each file can specify the major mode to be used toed, t It. Ine 
string »-*-Text-*-" at the front of thia file has that P^°®«- !t * 8 
also possible to specify in a file the value of any of the *any 
options and parameters that control EMACS The values thus ^™ 
will apply whenever EMACS is looking at that file. A so a user can 
specify in his start-up file that certain special .options should be in 
effect whenever he (and only he) is In a given major »°^ ^or 
example, my start-up says that auto f» I ^ould be on when ever I a 
text mode. If I read in this file, auto fill is turned or, out 
read it in. you won't be in. auto fill unless you ask for it. 

You can edit two windows at once. ^---^^Il.^rtr 
middle, and the top and bottom car, show wo d fferent f ilea or 
parts of the same file. You m.ght wan to put a » « 8 * °* XasK • 
F-ILCOM. in one part of the screen, while making the changes tn 
'other hal f . 

Uith large systems split up into many files it can be hard to 
remember what is in each file. Uith the EtIACS TAGS package you don t 
have to. It remembers all the location of each function definition or 
label in one or several files, and will jump directly to the 
definition of the function whose name you specify, switching files as 
necessary. TAGS uses a special file called a M tag table", which you 
must construct by calling a program provided for that purpose. Since 
it contains the character-position in the file of each tag, tags can 
be found without searching the whole file. The tag table Is not 
updated automatically when the file is edited, but this is not a 
problem, because a small inaccuracy mandates searching only a email 
part of the file, not the whole thing. 

One of the most avid EMACS users at MI T has written a "word 
abbreviation" package. If I define "pk H to be an abbreviation for 
"package", then I can just type "pk" and it will expand automatically. 
If I type "PK\ it will expand to "PACKAGE". W will expand to 
"Package". Some people have large files of abbreviation definitions 
which they always use. 

Word abbreviation mode is one example of a sharable EflACS library 
written by a user. Several users at MIT have written libraries for 
general use. including the PL/1 feature described above. Every 

library contains documentation for each command in it, so that the 

self-documenting features continue to work. 

EMACS is available to anyone for use on Twenex, on a communal 
sharing basis. Any generally useful improvements that you make, you 
must give back to MIT to share with everyone else, just as we have 
shared with you. If you plan to make improvements, you- should get In 
touch with MIT and other sites so that you can find out how to make 
them as widely useful as possible. Of course, whoever Is actually ^ 
Milling to do the work has more say than everyone else, but it is his 
responsibility to consider the needs of all users. 

If you would like to talk with other Twenex users of EMACS, you can 
contact the Computer Corporation of America, 575 Tech Square, 
Cambridge, MA 62139, or Geoff Goodfellow at the Stanford Research 
Institute. There are also users at DEC (I hear that the wa.ntalner of 
DEC PDP-10 TECO is one of them). 



Appendix: TECO. 

Some of you may haye tried programming in DEC TECO. It is very 
tedious, since you can't have very many variables or very many 
subroutines, and all error conditions must be detected explicitly. 

MIT TECO provides arbitrarily long names for variables and 
subroutines, thus allowing reasonable programming practices to be 
fol I owed. 

In add. «.ion, errors can be handled in several ways. First 
of all, you can put an error-catcher around some commands; an error 
inside will return to the catcher, also returning a pointer to a 
string containing the error message. Second of all, the user can 
supply an error handler which will be called in the environment of the 
error. In EMACS, this error handler allows you to look at the buffer 
and at the stack of macro calls. Finally, if you don* t do anything, 
the local binding stack (known in former times as the q-register pdl) 
will »>e unwound, so that global values of variables are never loot. 
Without these error handling features, it would be impossible to write 
reliable system programs. 

Also, data structures have been made more flexible and efficient. 
It may work even in DEC TECO to do 01U2 to move a string from Ql to 
Q2. This is because strings are represented by pointers. In MIT TECO 
we have taken advantage of this to pass pointers to strings much of 
the time. In addition, you can have pointers to other sorts of 
objects: buffers, for example (there can be any number of them) , or 
vectors of other objects (good for symbol tables, etc). Every buffer 
has a moveable "gap" which is invisible to the user; this is used to 
_make insertion and deletion in a local region of the buffer much 
faster. Insertion just uses up gap, while deletion increases the gap. 
Of course, you must move the gap to where you want to insert or delete, 
but that's better than moving half the buffer for each insertion or 
delation. The ability to use a temporary buffer for intermediate 
results reduces core shuf f I ing even more. As a result, when you edit 
a small part of a large file, only the part you are editing needs to 
be swapped in. 

Finally, MIT TECO contains an integral display processor designed to 
display an up-to-date picture of the buffer, using as few characters 
as possible to update on whatever sort of terminal you have. 

The best testimony to the effectiveness of MIT TECO as a system 
programming language is that about 8,080 lines of code have been 
written and debugged using it. 

Historical note: 

PDP-10 TECO (actually, PDP-6 TECO) was originally written at the ttlT 
Artificial Intelligence Laboratory in 1964 by Greenblatt, Nelson and 
Holloway. Some time later, DEC took a copy, but development of TECO 
at MIT did not cease. In 1973, 1 added the real-time display 
proc.-- -,^or , and the ability for each character to run an arbitrary 
program. Immediately, many users began to write packages of such 
programs: TECMAC, RMODE, DOC, MACROS, TfiACS, Rusa-mode, . * . This 
explosion of TECO program development allowed many ideas for useful 
commands and command languages to be tested. Until 1976, I played no 
part in this work, being content to add to TECO the features requested 
by the maintainers of the subsystems. EMACS was begun in 1976, 
drawing on what had been learned from all the other TECO program 
packages, as well as borrowing the code for some complicated commands. 
Some of the older programs have been supplanted entirely, some have 
been re- i mp I emented as cubtomi zat ions of EMACS to save their old users 
frntn havinn to re- 1 earn the command set: RMODE and DOC are 
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RANDOM IDEAS by Stanley Rabinowitz 

The following are my (subjective) ideas for possible future 
enhancements to TECO (TECO-11 in particular) . Comments 
-improvements, and other suggestions are welcome. 

m,n"E could mean execute the following commands if m=n. 

m,n"N could mean execute the following commands if m^n. 

"X could mean execute the following commands if a numeric 
argument exists. u eric 

4 " ™!r^° r perhaps n: "* < where X represents some conditional) 
could mean execute the following commands if n is NOT 

P^n^ e ^ bY /?? diti ° n -' F ° r exam P^' n"#D would mean 
for a di it W1Rg COrrunands if n is not the A SCII code 

5. Multiple I/O channels could be implemented in a more 
consistent and mnemonic manner than the current scheme 

»n^ S WS! ^ ER$ COUM mean Switch to in P ut channel n, 
ER's fnd ™Vo „ m ^ n T ltCh to . out P ut channel n. Thereafter, 
ER s and EW s without a numeric argument would work on 

wonlTo^ nt C £ a ? ne i' * n addition, nERfile$ and nEWfile$ 

channel * inPUt ( ° r out P ut) on the specified 

6. n+Atext(+A) would read input from the terminal allowing 
normal editing facilities. "text" would be used as a 
prompt. ^ Input is inserted into the text buffer before 
dot and is terminated when the character whose ASCII code 

nri? 1S Tf nt - er f',u If n= °' then in P ut is terminated by 
crir. it n— 1, then input is terminated by $$. Until 

r^oSt P and W rTPT t / T ? lina ^ d i ^^ editin 9 features, such as 
runout and CTRL/U would be permitted. 

? " fL C ^ d ^ e11 TEC ° t0 « Shrink or ex P and to nK bytes 
(words?) of memory. 0EC would mean to shrink to the 
smallest possible size. 

8. The match control construct CTRL/EM could mean search 
for multiple occurrences of the next match control 
construct (as in TECO-10) . 

9 * to^tht ^n d ^ be /. SUbr °^ tine Cal1 - Cont rol would transfer 
,,n*2? s ?ecified tag and upon execution of some as-yet 
I™ 1 "' d command which would correspond to a RETURN 
S^ a Ann.? I W ° U ^ reSUme foll ™ in 9 the :Otag$ command. 
2r?Hnn J ^ W ° Uld great1 ^ enhance the easibility of 
^^ g K g °°f. StrUCtUred TEC0 code - The command to return 
fpnhnfn^? ^■ mig !? t be somethin 9 like' :0$ although, 

nam^to ii y ' ^ S ShOUld mean Cal1 the subroutine whose 
name is the null string (represented by a I I tag ) . 

Frequently, at the beginning of a complicated macro it 
end'of'th^ t0 P \ Sh aWaY a l0t ° f Q-egisters and at the 
besM^h ' P °§ U ? em baCk * Such ^^ations could 
Y^a n ? n Y J ommands ld -ke [<A,B,C,D,...> and 

res^ectivei;'" W ° Uld PUSh and P ° P a Set of Q-registers, 



10. 
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^n ^?4- i 1S u U ?-° f the Moby Mun g^/ the editor presented 
n editorial chiding the differences- between TV and TECO 
^pne i following article is a rebuttal by Eric Osman, who * 

o? V w W ^ S ° me ^° f ^ he . featUreS ° f TV and ar ^ ues that the merits 
ot TV override its incompatibility with TECO. Further 
comments, both pro and con are welcome. 



ABOUT TV by Eric Osman 



^de h to M ?J C 2ni 9 IL 1SS i e ,?" the M0BY MUNGER ' som * mention was 
woutd nil f Elation to TECO. As . the father of XV, i 
would like to shed some further light on TV 




be 
so 



ITilti' IT t C ° mpIete repai ^ °* the creen can 
!«?!? t: N0te ' howeve r< that the window feature is al 
available on hardcopy terminals* u l al 



disa^nln^H*^ ^ fiVe « yaars ago and immediately was 
disappointed that no video TECO existed t nr rt r aft L^ ? 

create TV from VTECQ. vteco t ' Tc « 

running on T0PS20 when I arrived at DEC. 

*«re are some of the major points about TVs 
BACKUP SYSTEM: 




othersT^ haS the f0U0winq advantages over some 



Standard TECO has no automatic backup. 
Hence if the system crashes, you lose lots 
of work, unless you continually remember to 
"save your file" periodically, TV lets you 
forget about such worries and just type! 

Some editors feature an auto-save feature, 
which saves a copy of the entire file 
periodically. This has several problems. 
First of all, if it's a large file, y ou may 
not have dis* space for the extra copies. 
Also, saving an entire copy is verv 
expensive, TVs saving of only your 
keystrokes during the current editing 
session uses much less disk space and 
effort . 
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Another method of backup is to map the 
buffer to a file. This has the problem that 
after a crash, you have to figure out 
exactly when in relation to your tvplnq, the 
system crashed, so you can know which 
keystrokes "made it". 



FORGETTING TO TYPE I: 



All of us TECO users have at some point forgotten to 
type I at the beginning of an insertion string. 
After hittina two escaoes at the end of the command 
string and getting an error, TECO lets you recover 
if you type asterisk followed by a letter. 
Unfortunately, If you typed one non-asterisk, you 
aren't given the option of deleting it and typing 
the asterisk, TV has the ?G (semicolon G) command 
which insert's the last command string into the 
buffer that was longer than fifteen characters. 
Hence short command strings or extra keystrokes 
following a long insertion that failed don't prevent 
you from recovering your typing'. 



LARGE BUFFER AND HOLE: 



Instead of the standard TECO method of editing page 

by page, TV works most conveniently if you issue the 

jY command which yanks an entire file into the 

buffer, edit it, and then use ;x to exit. 

This avoids several pitfalls of TECO, For instance, 
an inadvertent Y command will give you an error, 
since no file is openi In many TECOs, inadvertent V 
commands cause the current page to be erased and 
replaced by another page! Another pitfall avoided 
is that of misspelling a search string. In TECO, if 
you say Nreciev$, TECO shuffles through all the 
pages of the file, then gives an error, since you 
meant NreceivS, Unfortunately, as minimal recovery 
effort, you must reopen the file, in TV, you would 
merely reissue the failing search, since no file is 
open, so the n would not clear the buffer or read in 
more data. 

Most TECOs allow the entire file to be edited in the 
buffer at one time. However, this is grossly slow, 
since every insertion or deletion requires the 
"rest" of the buffer to be slid over to make room 
for the insertion, or close the gap after a 
deletion, TV solves this problem with a hole, or 
bubble, in the buffer. This bubble floats to the 
location of an insertion or deletion, A deletion 
causes the deleted characters to be absorbed by the 
bubble. An insertion causes the bubble to shrink. 
Hence the amount of data necessary to be shuffled is 
reduced to the distance between one insertion or 
deletion to the next. For instance, the following 
command string, which inserts a carriage return 
after every sentence, could easily run a hundred 
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times faster In TV than TECOs 

J<$S,$; I 
s>$$ 

This is because every time TECO inserts the next 
crlf, the entire buffer to the right of where the 
crlf is being put must be moved right two places. 
In TV, only the sentence and its period need be 
moved, 

INCOMPATXBLITIES WITH TECO: 

TV is quite similar to TECO, and anyone starting to 
use T0PS20 who is familiar with TECO, can learn TV 
by merely knowing a short list of differences. 

Most of the incompatibilities are due to the fact 
that TV was created from VTECO, which is BBN's TECO, 
and already had the incompatibilities. 

Although having a compatible TECO is desirable, a 
number of the differences, I believe, are better in 
^ TV than TECO, For instance, having the file 
commands be ;R and ;.w etc, instead of ER and EW 
reduces the chances of runaway insertions causing 
irreparable damage. (A runaway insertion is one 
missing the 1 before it). 

Another incompatibility is that searches in 
iterations are not assumed to be "colon* searches in 
TV, as they are in TECO, This Is nice because in 
TECO if you forget a semicolon after your search 
command in an iteration, you get into an infinite 
loop. In TV, you'll get an error. 

Other incompatibilities could conceivably be 
resolved. 

All new commands that I have added to TV* I've tried 
to be compatible with TECO, For instance, TV now 
has most of the control»E search features. 

The original BBN VTECO, from which TV was created, 
started command execution when one escape was typed 
instead of the two that TECO waits for, I modified 
TV to wait for two, as TECO does. This was done in 
response to many people complaining that they 
■ accidentally typed escape in the middle of a command 

string (such as in an iteration) and execution 
started prematurely, in BBN VTECO, you type CTPL/D, 
which echoes as s, when you need a 
non-command-t er mi nating«e scape. 
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FUTURE OF TV: 



Although TV shows the editing buffer on the video 
screen, TV can not be used as a true video editor 
very conveniently. The true video editor allows 
keystrokes to cause immediate effect on the screen. 
For instance, if the pointer is in the middle of a 
line, and you type x to the true video editor, the X 
immediately appears in the line. Likewise, a 
subsequent DELETE character would cause the X to 
disappear, and the rest of the line would instantly 
slide left to fill the gap. 

True video editors also allow the user to associate 
keystrokes with macros. For instance, you may want 
to be able to type CTRL/S to save the current 
sentence. Then you move the pointer to a new 
location and type CTRL/v to insert the saved 
sentence here. This is only one of an infinite 
number of examples, 

A good example of a video editor is EMACS developed 
at MIT, 

Either TV will grow the ability to do what EMACS 
does, or EMACS will become the popular editor. It 
is not clear yet which of these will happen. 
However, true video editors are definitely the 
easiest editors to use. 



DIRECT. TEC - Installation Procedure (continued from page 20) 

To invoke DIRECT. TEC, you put the following equate in your 
login command file: 

DIR:=='MUNG' [loc] DIRECT, 

where [loc] is the name of the directory in which DIRECT. TEC 
resides. Note that the command ends with a comma and must 
occur after the definition of MUNG. 

To use DIRECT, you would issue a command of the form 

DIR filespec 

where "filespec" may contain wildcard *'s, ?'s, or %'s. 
For example: • DIR A*B.FOR or DIR [*]FOO??X.* 
"?" and "%" are equivalent. 



LIBERTY 
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Research Center, 71 Frankland Road, Hopkinton, Massachusetts 01748 • Tel (617) 435 3452 

Dear Stan: April 11, 1979 

irnm h ?nm°^T^ Cent ^ Mur J ger (#2 > Marcn 79) ^ ou P"bltshed'a commentary 
from Tom Mclntyre on the advantages and disadvantages of KED and TECO 
l think Tom did a good job of comparing the two from the editor 

*h^ 9 w- S /° in £ ° f vi ?Y? but he did not sa ^ much about some of ine 
that l find most compelling when it comes down to picking an editor. 
The most significant of these issues for me are: 

1. TECO exists (as you have extensively documented) in compatible versions 
J'' the DEC mainframes and operating systems. It seems very 1m- 
• E° r n^o he r? u t0 b , e able t0 move from RT-11 to RSX-11M to RSTS to OS/8 
to OS/78 without having to learn several different editors. Only maso- 
chists and gurus do that. It is particularly difficult to get • 

compatible editors when going from -8 based systems to -11 based 
systems. Compatible TECOs are either distributed free with the systems 
or are available from DECUS at low cost for all these systems. On the 
other hand, KED is not. It may or may not be available for RT-11. 
I have had trouble finding out about cost, etc. Somewhere down the road 
it might be announced for the other 16/32 bit systems although I know 
of no DEC commitment. I expect it to be at least a few years before 
it is available on all the -11 systems we use. Even then we still have 

let l SSU L °fo C ^- ** far as l know > there is no expectation of getting 
KED for the 12 bit systems. As noted above, this is a major disadvantage 

I v I III" • 

2. TECO runs on any terminal from a teletype to a VT-11 interactive qraphics 
display system. KED only works on a VT-100 (it might get VT-52 sup- 
port but don t bet too much on it). We have a teletype, DECwriters, 

a vr-bd and a VT-11 that need to be used with the editor we pick 
Exactly because, as Tom points out, KED is a DEC supported product, it 
1s not readily available to the users to modify or to add support for 
other devices. The decisions on which machines, operating systems and 
terminals will be funded for support, and when, is driven by DEC 
marketing considerations rather than existing users' needs. 

3. KED would be, most certainly, more user oriented, more "learnable", safer 
and more satisfactory for the vast majority of users than TECO is. The 

now av^hl2 U nn d ^ S r US l S the TEC0 Vide0 term1nal su PP°rt that is 
now available on all the systems we are interested in. With it a 

X? r ?m n n2 vr h ii VT ™ T macr ° Can be used on a11 sterns with a VT-52, . 
VT-100 or VT-llgiving a screen oriented editor that can be learned 
by naive users in minutes. The new user will be able to move across 
all our systems with almost no further training. 

When KED_is available on at least all the -11 systems we use, it is low 
cost, and works with the terminals we have, I will give it very serious 
consideration as an alternative to TECO. When KED is supported in this 
way on our 12 bit systems (i.e., pre Omnibus included) I will almost cer- 

W?Ibl?p2??n? V ?n^ 1t "H Unt11 then ' TEC ° c °n«™es as the only useful, 
%#rtabie editor for me and my user community. 

Very truly yoiirs, 
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MORE ERRORS IN TECO REFERENCE CARD 

Since the last issue of the Moby Munger, we have noticed a 
few additional errors in the TECO Pocket Guide (AD-D530A-TK) . 
These are described below: 

5. Page 3, the explanation of the EC command, "moves the 
remainder of the input file to the output file ..." should 
read "moves the text buffer and the remainder of the input 
file to the output file . . . " . 

" 6. Page 4, the list of legal switches under TOPS-10 * s 

missing some switches. In addition to /GENLSN and /SUPLSN, 
TECO also accepts the switches /SCAN, /NOCREATE, /NOWRITE, 
/SYS, and /NEW. 

7. Page 11, in the explanation of the ES command, "an effective 
mV- command is executed when a search is completed" should 
read -'an effective mV command is executed when a successful 
search at top level is completed" . 

' 8 Page 12, under CASE CONTROL, we are missing the 0\V and-0+W 
commands. These should be printed in red since they are 
implemented in DEC s TOPS-10 TECO only. These commands 
are identical and take TECO out of case conversion mode. 

9 Page 13, the search string build commands CTRL/V and CTRL/W 
should both have a note that reads "use of these constructs 
in a search string causes the search to be executed in exact 
case mode under TOPS- 10 " . 

10. Page 14, the explanation of the ?MEU error message should 
read "Macro ending with +", not "Macro ending with U" . 

11. Page 16, the graphic for the ASCII character whose octal 
ASCII code is 140 should be ", not " . (The accent is 
slanted the wrong way.) 



ERRORS IN MOBY MUNGER 

The following errors in past issues of the Moby Munger have 
been noticed: 

o In the NOTES FROM RT-11 on page 6 of issue #1, we said that 
under TECO- 11 V28, the n+W command (with n<-2) performs a 
screen update. This is wrong. It merely tells TECO _ that 
|n|-l lines have changed on the screen. The window is not 
actually updated until the next -1+W command (not when TECO 
goes back to prompt level) . Note that in versions of TECO-11 
after v28, the window command is W rather than tW. 

o DECUS has informed us that the program, DECUS-L-125 described 
on page 53 of issue #2 is no longer available from the DECUS 
program library. 

o Issue #2, page 7, "TECO. TEC" should read "WILD. TEC". 
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WPI TECO version 1(165) 

WPI TECO is a modified version of DEC' s TOPS-10 TECO v23. 
t was modified by Al Johannesen at WACCC who is also the 
Current maintainer. Should anyone desire a copy, Al will 
send a copy to anyone who supplies the media. His address is 

Al Johannesen 

Worcester Area College Computation Center 
Worcester Polytechnic Institute 
Worcester, MA 01609 

We described .many of the features of WPI TECO in the last issue 
of the Moby Munger. The following new features brings us up-to- 
cjate. This information describes WPI TECO vl(165) and is 
current as' of June 1979. 

13. 1EP sets the page number display flag. 

14. 64EP allows an EB command to be prematurely terminated 
(current output file remains as a .TMP file) . 

15. 12 8EP re-enables normal use of the Y command. 

16. EY is the same as Y but must be used instead of Y at command 
level (unless 128EP is set) . 

17. nfP pages out to page n. Truth-in-paging mode (4EP) must be 
set. 0+P pages to the last existing page in the file. 
Backward paging is not permitted.. 

18. .:= and :== were implemented' as in OS/8 TECO and TECO-11. 
(They suppress the crlf ) . :Xq was implemented as in 
TECO-11. (Appends to Q-register.) :T and :EQ are like T 
and EQ but control characters (including carriage return, 
line feed, and tab) will be typed out in up-arrow mode 
regardless of the prevailing typeout mode. 

19. <CTRL/G><FORM-FEED> is an immediate mode command that re- 
types' the entire command string. (<CTRL/G>* on some other 
TECOs.) 

2#. nV is identical to -nT(n+l)T . V is the same as 0TT. 
(I prefer V to be the same as IV and to define nV as (l-n)TnT.) 

21. nFDtext$ (Find and Delete) is equivalent to nFStext$$ . 
m,nFDtext$ is equivalent to m,nFStext$$ . 

(Andy Nourse' s TECO-10 has implemented this version of the nFD command.) 

22. To save space, +F, +H,' and EM were removed. 

23. When using : or @ modifiers, any numeric arguments must go 

after the : or @. (This seems like an unnecessary restriction.) 

24. An additional Q-register, #, has been added. This reg- 
ister normally contains the filename last referenced by 
an ER or EB command. (This is a true Q-register, unlike the 
pseudo-Q-register , * , used by TECO-11 for a similar purpose. I think 
that real Q-registers are better than pseudo-Q-registers . * is a pseudo- . 

Q-register under TECO-11 because it can only be used in limited contexts.) 

25. The source is now written in FAIL. Also many internal 
speed-ups have been made. (Some speed-ups, like use of AC 
loops are of use only on KA10S.) 
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XTEC 



1. 



2. 



XTEC is a TECO compiler for the DFf^vqTPM i a 

TOPS-10 or ITS (under the compatibly t Me f "£? Under 
» available from the DECUS program librarv 9 tI " ■> S P ro 9 ram 
is DECUS -10-2 64. It wac w»-^t»„ i 1: , V ' Its orde r number 

Mark R . Crfspin-at's^ree^rinstituL'of^ohnol^r^Tr 115 ■ 

m the DECUS library iq ±tt(A'>i\ ~ Z ?f J _ i f ci ? nol °gy • The version 

As far as I know^is^ ffiitE^^ ^^ ° f 

a com p T fLr\^tL\ er rhfn\ f n te inre%\ e eter TE ^s ( mosrTh 123) - " iS 
When you start execution of a command icrina n? ^ TEC ° S are) • 
ecute a Q-Register, XTEC compile^t^ Sn 9 ', . Wlle ° yOU ex_ 
machine language. Re-execution of ?L C ° de lnt ° PDp -^ 

recompilation unless the contents of theT*^? d °Z B " 0t Cause 
XTEC execution is over an 1„ f«= ihe Q-Register has changed. 

TECO execution of rhfsame^ECO program^" 6 '"^ than Ste ™»* 

la./lSS'o^Se'Sg^^-^- ^ es 33 and 34 of the 
Stevens. TECO' are describe^beiowf dlff fences between XTEC and 

macro? e botr?he b |irst U instruct m * "^ " y ° U COl ° n the 

be "coloned"' h returning n f vaxue°of a -l if^"^ maCr ° wil1 
it fails. e or 1 lf xt succeeds, if 

Values passed to a macro must be conqi^fonf ,'~ 

usages of that~¥acro. consistent m number m all 

XTEC supports Q-Register names of up to six char^fprc t* 
more than one character iq „cori *-u ^ characters. if 

enclosed by parentheses. For example ' L"™ ^f ^ 
executes the macro whose name is "PMNT" ^"T^ « (PRINT) 
names for TECO "variahl PO » !=vl PRINT . Allowing symbolic 

variables makes for much more readable code. 

The EI command uses a temporary Q-Register and does not smash 

withourgoing^nvthinT ^t??***^** 00annand is aborted 
will generate a^error 'messaae anH th * co ™™ d string HK= S$ 
buffer. message and will not destroy the text 

XTEC has different filespec blocks for Pa ^h t /r, 

(used for filespec defaulting)? I/0 comma nd 

The W command of Stevens TECO is not in XTEC 
le h ^ef 2 V o a f U s e t ° ve ^ EC ^^ < f -ctionally equi^lent to EO 

pi ^S^SL? 18 ^^-^? ty L e I n .^ a ^E d c t0 .ll Se 

c^inufexeS 0^^^^ mmand tinU Th S ° n f ^ - t^ 
ignored. (This Is very confuTfto™»L.> hlS CharaCter is 

^,^PP° rt ! ■**» following switches in filespecs- /SIXBIT /a^tt 
/OCTAL, and /PROTECTION :nnn. /SIXBIT Vead/fhf J ,' /ASCI1 ' 
SIXBIT. /oj.abj.1 reads the file in pure 
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HARVARD UNIX TECO (hrsts teco) v6 

^•^iarvard UNIX TECO runs under the UNIX operating system on a 
PDP-11. It was written by Bob Case, Peter Langston, Bruce 
Borden, Brent Byer, and Tucker Taft using the Harvard-Radclif f e 
Student Timesharing System (HRSTS) . A manual, written by 
Daniel Waugh and Ken Strong, is available from the HRSTS 
System Manager. For more information, or to obtain a copy of 
this TECO, write to 

Stephen Dyer 

HRSTS System Manager 

Harvard Science Center 110a 

1 Oxford St. 

Cambridge, MA 02138 

Educational institutions can obtain this TECO for a nominal fee. 
Harvard UNIX TECO is based on a 1973 version of MIT TECO and is 
written in MACRO-11. There is a possibility that this TECO will 
be expanded and recoded into C in the near future. 

The following list summarizes the advanced features of Harvard 
UNIX TECO by specifying those features that are not in other 
traditional TECOs such as DEC ' s TOPS-10 TECO. 

I. LF, if typed as the first keystroke after TECO's prompt,' 
performs an effective LT command. 

,:. $ or >, if typed as the first keystroke after TECO's 
prompt, performs an effective -LT command. 

3. CTRL/A immediate mode command is equivalent to RUBOUT. 

4. The immediate mode command CTRL/B aborts the command string. 

5. Space eats numeric arguments. 

6. EDfile$ deletes the specified file. 

7. EY replaces the traditional Y (Yank) command. 

8. ET (Top) repositions the input file to the beginning of 
the file. 

9. EQ (Quit) and tD+D cause an immediate exit from TECO. 

10. nV is equivalent to -nT(n+l)T . V is the same as 0V . 

II. :T and :V are like T and V except that the type-out 
shows non-printing characters. For example, space prints 
as <SP> and the character whose ASCII code is 1 (CTRL/A) 
prints as <SOH> . 

12. The K command not only kills text but in addition. performs 
an effective ;X@ command. This puts the killed text into 
pseudo-Q-Register @ . Thus, you can get the deleted text 
back with a G@ command. 

\3.. . E-<-text$ replaces the traditional -<-text$ destructive global 
search command. 

t h 
14. nFDtext$ finds and deletes the n copy of the specified 
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HARVARD UNIX TECO (cont.) 

15 Match control constructs have been shuffled around a bit. 

CTRL/Q matches any character, CTRL/P matches any separator, 
and CTRL/E is the quote character. 

16. Upper and lower case Q-Register names are distinct. 
(This has proven to be a lose in other TECOs . ) 

17. :Xq is like Xq but the extracted text is deleted from the 
text buffer. 

18. The Edit Macro command, EMfile$q$, reads the specified file 
into the specified Q-register. 

19 The Exchange Environment command, EEq, 'moves' you into 
the specified Q-Register. That is, the text in that Q- 
Register appears to be the normal editing text buffer and 
the original text buffer has been saved away in a pseudo- 
Q-Register. While in this mode, TECO's prompt changes to 
q* where 'q' is the name of the Q-Register you are editing 
in. The EE$ command restores the context to the main 
text buffer. (A very useful command.) 

20. «- returns the negative of the number of characters in the 
last search string. 

21. Q<- returns the position of the beginning of the last match. 
.22. Q]' returns the position of the pointer before the last search 

23. Q[ returns the position of the pointer before the last insert 

24. tE flag is a 1 if end-of-file has been reached. 

25. fWtexttW types out the specified text (traditional tAtext^A) . 

26. +L clears the screen on a video terminal. 

27. EI$ (E-bang!) spawns a sub-shell. When the user logs out 
of the sub-shell, control returns to TECO. 

28. Elcmd$ spawns a shell to execute the single command speci- 
fied and then control returns to TECO. 

29 All flags are handled in a consistent manner by the commands 
ESf, ECf, and EVf where f is the flag name. (Each flag name 
consists of a single character.) ESf sets the specified 
flag, ECf clears the flag, and . EVf returns the value of the 
flag. (0 represents off and -1 represents on.) 
A description of a few of the flags follows: 

Flag Description 

B controls creation of .BAK files 
C controls whether or not typing CR on terminal 
enters CR/LF or LF only 

E form feed flag 
L long error message flag 

T trace mode (causes user commands to be logged in a 
file called TECO. TRACE) 
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TV 

TV is a TECO variant that runs under the TOPS-2j2f operating 
system on a DECSYSTEM-20. It has many features in common with 
**»the other TECOs available at DEC, but it differs from 'traditional' 
TECOs more than the other TECOs that have been described in 
recent issues of the Moby Munger, The main problem is that 
the common commands R, ;, E, and F behave radically different 
under TV than they do under traditional TECO. 

The information I have on TV is current as of July 1978. 
TV contains the following features that are not in other DEC 
TECOs : 

1. ;Y means yank the entire input file into memory. 

2. @J moves the text buffer pointer to the center of the screen. 
(TV sort of maintains a window into the text buffer on the 
screen of a video terminal.) 

3. ;U means finish edit but stay in TECO (equivalent to the EC 
command of. TECO-8 and TECO-11) . 

4. Negative arguments to a search cause the search to proceed 
. backward. The pointer is left positioned at the beginning 

of the string found. 

5. ;G gets the last command string that was longer than 15 
characters in length and inserts it into the text buffer. 

6. ' ;Efile$ causes subsequent input to TECO to come from the 

specified file. 

^■#7. nRa$b$ causes the next n occurrences of string "a" to be 
replaced by the string "b" . 

. 8. +G means exit from TECO (as in DEC * s TOPS-10 TECO, EO level 1). 

9. CTRL/G run-time command aborts execution of the currently 
executing TECO command, (why isn't this ctrl/c?) 

10. Backspace, if typed as the first keystroke after TV's 
prompt, performs an effective -LT command. 

11. Linefeed, if typed as the first keystroke after TV's prompt, 
performs an effective LT command. 

(The above two immediate mode commands are now in TECO-11 V33 and 
TECO-8 V7.) 

12. tL clears the screen. 

13. Carriage return eats up any pending numeric value. 

14. CTRL/Q is an immediate mode quote character. 

15. CTRL/U if typed as the first character in a line of a command 
string, deletes the previous line of that command string. 

16. $ (dollar sign) clears the current numeric value. 

17.' ;D puts a heading at the beginning of the buffer and then 
issues the ;U command. 

18. ;H exits from TECO (why isn't this *c?) . 
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TV (CONT.) 

19. ;Mqfile$ loads the specified file into Q-Register q. 

20. ;P combines the 0A command followed by a C (returning the 
value picked up) . 

21. ;S saves entire buffer then closes file. m,n,-S saves the 
portion of the text buffer between pointer positions m and n 
and then closes the output file. 

22. Qq;T types the string contents of Q-Register q. 

23. ;Tmessage$ types the specified message. 

24. nE is the same as nL2R, that is, it is like L but is used to 
position yourself at the end of a line (before the CR/LF) 
rather than at the beginning of a line. 

25. n:K is the same as nK but doesn't kill the final CR/LF. 

26. :L moves the text buffer pointer to the end of the current 
line (before the terminating CR/LF) . 

.27. Failing searches don't move the text buffer pointer. 

28. V, nV, and m,nV are the same as the corresponding T commands, 
except that the specified range of text is displayed on the 
screen. 
-29. The hXq and m,nXq commands delete the extracted text from the 
text buffer automatically. 

30. Searches in iterations are not automatically colon modified. 

31. A period immediately following a digit string acts as an 
'octal point', that is, it causes the number to be interpreted 
in base 8. 

32. There is a large number of W commands, of the form Wword$ 
where 'word' is mnemonic for some TV feature." For example, 
WVT05$ tells TV that you are editing on a VT05 terminal. 
WFLAGLOWER$ institutes lower case flagging. (0EU on other 
TECOs.) 

The following TV commands are exactly equivalent to (or very 
similar to) the corresponding TECO commands: 



TV command 


TECO command 


TV command 


TECO command 


;x 


EX 


;u 


EC 


Ra$b$ 


FSa$b$ 


+Atext$ 


+ Atext @) 


;c 


EF 


;Ftext$ 


«-text$ 


;N 


\ 


n;N 


n\ 


;Rfile$ 


ERfile$ 


;Ttext$ 


+ Atext <AA^ 


;Wfile$ 


EWfile$ 


;<space> 


/ 


Ftext$ 


Ntext$ 


CTRL/R 


CTRL/G<spa 



One interesting difference between the ;X command and the EX 
command is that ;X will prompt you for an output file name if an 
output file is not open. 
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;iT TECO. (its teco) 

This version of TECO is incredible! It runs on a DEC-SYSTEM-10 
under the ITS operating system at MIT. MIT is where TECO began; 
they have kept way ahead of all other TECOs. 

For most other TECOs described in the Moby Munger, 1 complain 
that the author's have made incompatible changes with DEC TECOs. 
In this case it is just the opposite - MIT TECO existed long 
before DEC'S versions and DEC made many incompatible changes. 
Our only excuse is that we did not know what MIT was doing. 

At MIT, TECO has grown very powerful; it is an order of magnitude 
more complicated than DEC'S TECOs and has an equal abundance of 
functionality. It is even more cryptic and packs more power per 
character. My only comments are: fantastic I Stupendous! and 
My God! 

The only documentation I have on MIT TECO is an 8 0-page list of 
commands. If there is a printed manual, I would appreciate 
receiving a copy. The information I have is accurate as of 
2-Nov-1978 and describes TECO version 709. 

There. is too much functionality in this version of TECO for me 
to possibly describe it all in this column. Instead, I will 
nly describe a few of the features (in little detail) . Future 
issues of the Moby Munger will describe additional commands. 
Inclusion of a description of a command in this column in no 
way is an endorsement of the merits of that command. 

1. n+@ is the same as . , .+n if n is positive. 

2. IA is an inclusive-or arithmetic operator. 

3. +L clears screen when executed. 

4. tOfilespec$ bigprints the specified filename on the ^.device 
open for output. 

.5. +0 in a search string is a special character signifying "OR", 
that is, it divides the search string into two strings 
either of which will satisfy the search. 

6. +P is a sort command. The description of the arguments and 
how this command works fills up an entire page and is too 
lengthy to reproduce here. Perhaps someone would like to 
contribute an article entitled "SORTING WITH MIT TECO". 

7. niZ inserts n random letters before the buffer pointer. 

8. Any conditional can be reversed by preceding the " by a 
colon modifier. Thus 0:"E fails. 

9. # is an exclusive or arithmetic operator. 

J&. ( turns off the colon and @-sign flags. The matching ) 
turns them on if and only if they were on before the ( , 
but will never turn them off. 

11. : and @ are both general command modifiers. Preceding a 
command by either or both of these modifiers changes the 
command into a different (but usually similar) command. 
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MIT TECO (cont.) 

12. n= outputs the value of n in the current output radix. The 
output rcidix is initially decimal and is kept in a special 
Q-register whose name is . .E (MIT TECO has lots of special 
Q-registers of this form) . 

13. @> is the same as > except that the iteration count is not 
decremented. !<!@> is a good way to jump back to the start 
of the iteration without decrementing the count. The reason 
for the angle bracket in the comment is so that if the 
iteration should end earlier (say by a 0-, command) , then 
TECO won't branch to this > , since it will see the < 

(MIT TECO doesn't ignore angle brackets found in strings 
or tags) . 

14. n:A appends n lines of the file (but won't append beyond a 
page boundary) . 

15. :C is like C, but returns -1 ordinarily. It returns if 
C without the colon would cause an error. :J and :R act. 
in a similar manner. (:D doesn't seem to be implemented 
though.) 

16. EDfile$ deletes the specified file. 

17. E[ pushes the input channel if any. Saves the current input 
file and position in it, or saves the fact that no file is 
open . 

18. E] pops the input channel. If any input file was open, 
the rest of it is flushed. 

19. E\ pushes the output channel. 

20. Et pops the output channel. If an output file is open, it 
is closed without being renamed. 

21. m,nFt@ returns two values, which are m and n in numerical 
order. 

22. FtY returns a value saying how many args were given it 

(in the low order 2 bits). The 4's bit is turned on if a 
: preceded the FtY and the 8's bit is turned on if an @ 
preceded the command. 

23. Within a macro, FtX returns as its value, the arguments 
that were given to the macro. This command is frequently 
followed by a FtY to determine the number and nature of 
those arguments. 

24. FQq returns the number of characters in Q-register q. 
-1 is returned if the Q-register contains a number. 

25. m,nGq inserts only a part of the text in the specified 
Q-register. Specifically, the range from m to n-1 
inclusive is inserted. 

In this article, we have only been able to touch upon a very 
brief sampling of the commands in MIT TECO. We will continue 
this article in the next issue of the Moby Munger. 
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MULTICS TECO 

MULTICS TECO is a- version of TECO that runs under the MULTICS 
operating system on a Honeywell computer. It is of interest 
to us because it is based on an early version of MIT TECO and 
consequently, its advanced features highlight those features 
of MIT TECO that were deemed most useful, Multics TECO was 
first written late in 1970 by Richard H. Gumpertz , then working 
for MIT. Later, Peter Bishop, also working for MIT became the 
maintainor. In 1972, David Levin at Honeywell became the 
principal maintainer and augmenter until 1977 (or 1978) . In 
1976, Richard G. Bratt" added a slew of features derived from 
ITS TECO. In addition, in the mid 1970' s, several other 
people at the Cambridge Information Systems Lab (the Multics 
System Software arm of Honeywell) , such as Mike Grady and 
Larry Johnson, added certain additional features. 

TECO's status in Multics is that of a 'tool'; it is not 
part of. the standard service system and is used primarily by 
sophisticated systems programmers. 

My thanks go to Bernie Greenberg who provided me with 
the information for this article which comes from Publication 
AZ03, "Multics System Programming Tools". (Incidentally., 
Bernie is the main implementor for a Multics version of EMACS 
written in LISP.) 

A significant difference between Multics TECO and the 
TECOs that you may be familiar with is that Multics TECO does 
not use any special characters like ESCAPE or control characters. 
This is probably because early Multics users ran Multics on 
terminals that could not transmit these characters. Consequently, 
all strings are essentially @-sign modified, although no @-sign 
is required. Thus, to insert some text, you type I/text/ and to 
search for a string, one would type S/string/ where "/" denotes 
any non-alphanumeric character. In addition to the /text/ 
form of a quoted string, the construct Qq may also be used, where 
q represents the name of a Q-register. Thus SQA searches for 
the string that is stored in Q-register A. Command _ string 
execution is begun by ending a line with a dollar sign ($) 
(followed by a newline) . Other than these differences, Multics 
TECO looks very much like traditional TECO. 

The following features are extensions to 'traditional' TECO: 

1. There are 9 5 Q-register s, one for each printing ASCII 
character. 

2. | is used as the boolean 'or' operator. 

3. Input and output is a bit different because complete files 
are read into the text buffer so there is no need for 
paging; consequently no need for the A, P, Y, or PW 
commands. A file is read in with the El/file/ command 
and written out with the EO/file/ command. EO can also 
take a numeric argument or argument pair representing a 
range of characters to output (as in the T command) . 

4. m,nS/string/ is like nS/string/ however only m lines 
are searched. (This is a bounded search command) . 

If m is negative, previous lines are searched. If n is 
negative, the search proceeds backwards and a successful 
search leaves the pointer at the beginning of the string 
found. 
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5. N/string/ searches for a regular expression, string. 

6. m,n= types out the two numeric values separated by a space. 

7. n:= types out the value of n in octal. 

8. EQ (External Quit) exits TECO. 

9. :Iq/string/ or n:Iq inserts the specified text into 
Q-register q. 

10. n:L is equivalent to nLR (i.e. it moves to the end of 
the line rather than the beginning) . Note that in 
Multics, lines are ended by a single newline character. 

11. n:J, n:C, and n:R are like nJ, nC, and nR except that 
■if the text buffer pointer would be moved out of bounds, 

no error is generated and the text buffer point is set 
to B or Z as appropriate. 

12. m,nUq is equivalent to nUqm . 

13. m,nPq is like m,nXq except that the text is appended to 
the specified Q-register. (The letter P was free in this 
version of TECO, however, for TECOs that do paging, I recommend 
the :X command to be the append to Q-register command.) 

14. :< and n:< are like < and n< except that errors that 
occur within the iteration group just terminate the group 
and the > returns a value. -1 is returned if no errors 
occurred, is returned if the iteration terminated due to 
an error. 

15. :; is like ; except that the sense of the test is reversed, 
n; exits the current iteration if n<0. 

16- If the target of an 0. command is not found in the current 
macro level, the previous macro level is searched. This 
continues back to command level. Although a GOTO can exit 
a macro, it cannot be used to exit an iteration. 
(A funny mixture of extension and restriction. ) 

17. :Mq, if issued from within a macro, causes a return from 
that macro to occur when macro q is returned from. 

18. EM/file/ executes the TECO commands stored in the specified 
file. 

"19. String arguments may be passed to a macro. The general, 
call to a macro has the following form: 



m 



, nMq/arg 1 //arg 2 //arg 3 / 



The command :Xq, if issued from a macro, puts the next 
argument into the specified Q-register. (The first :Xq 
gets the first argument, the next :Xq accesses the second 
argument, etc.) The macro and the caller must agree on 
the number of arguments, since when the macro is exited, 
control resumes with the first character after the last 
string argument that had been fetched. 
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20. m,n"E...' executes the commands if m=n. 
m,n ,, N...' executes the commands if m/n. 

21. "M/string/. . . ' executes the commands if the specified 
string appears in the text buffer just to the right of dot. 
: "M is like "M except the sense of the test is reversed. 

22. :' transfers to the next '. This is useful in creating 
if-then-else statements, e.g. n"Xthen: " else ' . 

23. VW reads a character from the terminal and returns its 
ASCII value. (We are familiar with this as a CTRL/T command.) 

24. :VWq reads a line of text from the terminal and puts 
it into the specified Q-register. 

25. EC/string/ passes the string to the Multics request 
processor (command processor) for execution. 

26. EAq/string/ passes the specified string to the command 
processor's active function application entry. The result 
is returned in Q-register q. 

th 

27. nA returns the ASCII code for the (.+n) character in the 

buffer. 1A gets the value of the current character (the 
one just to the right of the text buffer pointer). 
(This is compatible with MIT TECO as opposed to TECO-11.) 

28. :\ is like \ except that radix 8 (octal) is used. 

29. m,n\ inserts the decimal interpretation of m into the text 
buffer (before dot) . It is padded on the left to be at 
least n characters wide. 

30. $ (embedded dollar sign) throws away any numeric arguments. 

31. Special loop facilities are provided for throwing and 
catching values. F< and > define an iterative group like 

• < and > . From the time that the F< iteration group is 
entered until the time it is. exited, F< sets up a handler 
to "catch" values thrown by the F; /label/ request. If no 
F; /label/ request with matching string argument is executed 
before the F< I label! group is. exited, the iteration 
group returns -1 as a value. If, however, an F; /label/ 
request is executed (where the /label/ matches' one that 
immediately follows the F< , i.e. F< I label!), then the 
execution of all macros and iteration groups encountered 
since the F<! label! is abandoned, and the F< iteration 
group returns the numeric argument of the F; request as a 
value. :F<! label! is like F< I label! except that if an 
error is encountered during the execution of the :F< group, 
the latter returns as value. These requests provide a 
method of exiting several nested loops at once. Execution 
of a F; command terminates the F< loop as well as any 
contained loops. 

32. The Q-register " always contains the last quoted string 
that has been referenced by TECO. 

33. :T/text/ types out the specified text on the terminal. 

34. A period at the end of a digit string is an "octal point". 
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TECO NOW RUNS ON YOUR HOME COMPUTER: 
. TEC65 

TECO ON 6502 MICROCOMPUTER SYSTEMS 

A subset of TECO developed to run on 
Microcomputer systens using the 6502 Micro- 
processor chip is available for systems using 
TIM, SYM, and KIM Monitors. It is also soon 
to be available for APPLE II systews. 

TEC65 (as it is naned) was written by 
Larry Fish of Denver, Colorado who becaMe 
faniliar with TECO implemented on «i PUP- 10. 
TEC65 requires just, under 4K bytes of RAM. 
Total RAM required depends on the amount of 
text you wish to handle at one time. SYM and 
KIM versions allow saving and loading of text 
via the cassette ports provided. " The new 
APPLE II version will Make use. of APPLE II 
Disk hardware. 

A catalog describing this and other 
6502 software is available for $1.00 from the 
6502 PROGRAM EXCHANGE, 2920 U MOANA, RENO, NV 
89509. 

David P. Marsh 

Vice President 

The 6502 Program Exchange 

292 Moana 

Reno, NV 89509 

Remarks from the editor : 

Yes, it's really true! To quote from the catalog, "There is 
no reason why you shouldn't have one of the finest text- 
• editors on the market today". 

I've got a copy of the TEC6 5 manual, and indeed, they have 
a real TECO, although it's a subset of the traditional TECO 
for the -10. 

The following commands are implemented: 

C, D, FSa$b$, Gq, Itext$, J, K, L, Mq, T, Xq, =,<...>, Stext$, 

;, Ntext$, *q, EX, ., H, B, Z, and TAB text $ . 

There are also a few other I/O commands that are riot compatible 
with traditional TECO, so I won't go into them here 
Q-register names are limited . to through 9. There are also 
the usual immediate action commands such as rubout and CTRL/U 
as well as LF which performs an effective LT if typed as the ' 
first character after TECO's prompt. Also CTRL/G which 
executes an effective 0LT and ESC which executes an effective 
-LT. The match control construct CTRL/X is also permitted in 
search strings. 
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QUESTIONS and ANSWERS 

This column will attempt to answer questions. -submitted by 
readers on any TECO-related topics. Queries should be submitted 
to the editor, Stan Rabinowitz, 6 Country Club Lane, 
Merrimack, NH 03054. 

Q4. by Ronald J. Price (U.S. Environmental Protection Agency, 
Houston, Texas) 

I am presently using version 3 of DEC's OS/8 TECO, but I 
have version 4 . How can I get information concerning the 
differences in the two versions? 

A4. V4 came out with a new release of OS/8 and has no new features 
but contains bug fixes. You should be using V4 rather than V3 
because it is solider. In fact, you should get the latest 
version (V5) since it has considerably more functionality than 
V4. 

Q5. by Ronald J. Price 

I am using OS/8 TECO on a PDP-8/E with 32K memory. How can 
I increase the Q-register size from a maximum of 2000 
characters to something larger? 

A5. On 8K machines, you get 2000 1Q characters in Q-register space. 

On machines with 12K or more, you get a maximum of 2944 1Q 

characters in Q-register space (although no single Q-register 
may contain more than 2 047 characters) . I know of no way 
to increase this limit of 2944. Allowing Q-register space 
to cross field boundaries is a very tricky operation; 
although with 32K you have lots of room to write tricky code. 
If anyone can provide a patch to OS/8 TECO to allow 
expanded Q-register space, please write in. 

Q6. by Dr. R. N. Caffin (Division of Textile Physics, C.S.I.R.O., 
Ryde, N.S.W.) 

I have several questions on VT52 support under RT-11. 
The Backspace (BS) key is meant to move the cursor to the 
end of the current line. However, under certain conditions 
after editing within the line, it fails to do so: it ends 
up some characters short of the end. Does anyone have a cure 
for this? 

A6 . I have never encountered any problems with the BS function. 
Please check that you have an uncorrupted version of VT52 
(better yet - switch to VTEDIT) . If the problem recurs, 
please try to send circumstances which can be duplicated 
which cause the error to happen. Note that the implementation 
of this function is not too swift; it simply executes the 
TECO commands L2R. This means that if the line ended with 
something other than CARRIAGE- RETURN / LINE-FEED, typing the 
BS key may not do what you expect. This could happen if the 
line ended with FF or end-of-buf f er . 
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Q7. by Dr. R. N. Caff in 

Could we arrange to have future releases of VT52.TEC to 
omit the screenful of keypad layout, assume that all 
necessary files (except for EDIT. TEC and the text file) 
are on SY:, and to allow lower case handling automatically? 

A7 . The source of VT52.TEC is distributed in all releases. 

This allows users to make their own custom modifications. 
We can't please everyone, so we release it with the 
options that we feel are most useful. You should feel 
free to make your own modifications (but be sure to docu- 
ment them; and don't send in any bug reports unless the 
bugs occur in the macro as distributed by us) . 

Q8. You mentioned in MOBY MUNGER #2 the existence of VTEDIT. 

An interesting extension of VT52, with its word orientation, 
but how does one get a copy? 

A8 . By the time you read this, VTEDIT should* have been submitted 
to the DECUS library, or will be shortly. Wait for announce- 
ment of availability from DECUS, then order it from DECUS. 
Copies were also given out at the last DECUS symposium. 

Q9. What is the chance of including officially, in VT52, the 

command CTRL/P for "scroll one page-full forward" and (say) 
CTRL/Q for "scroll one page-full backwards"? It's a very 
useful facility for browsing through a long listing or a 
piece of text. 

A9. The latest version of VTEDIT (VI. 00) already has this feature 
(but with a different syntax) . See elsewhere in this issue 
for the functionality of the latest version of VTEDIT. 

Q10. Is anyone working on an extension to VTEDIT which will allow 
direct preparation of text, bypassing the use of RUNOFF? 
The 'main features required are the automatic adjustment of 
words in a paragraph following an insertion or deletion, 
right margin justification and listing with page numbers. 

A10. I know of at least two people at DEC who have macros that 
do this kind of thing. I can only hope that they will 
submit them to the DECUS program library. • 

Qll. Is it possible for TECO to perform direct output to another 
terminal or line printer? 

All. Yes. Unless the operating systems denies you access (say 
if the line printer is assigned to another job) there is 
no reason why you can't perform an EW command to such a device 
If you are using TECO-11 and you are in the middle of an EB, 
you can open the line printer (or terminal) for output on 
the secondary output channel by issuing a command such as 
EA EWLP : $ and then issuing P commands. The EW$ command then 
switches you back to the primary output channel. 
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Q12. by Dr. R. N. Caff in 

In humble ignorance., what is the meaning and origin of MUNG? 

A12. MUNG is a recursive acronym for Mung Until No Good. This is 
what you typically do to files with TECO. I believe the 
word originated at MIT but am not sure. Better information 
concerning the origin of this word would be appreciated. 

Q13. by Chester Wilson (Charleville Australia) 

I have the DECUS TECO release for RT-11 and am having a 
difficult time working out such things as changing the 
default ET and ED values. Is there a simple way to do this? 

A13. RT-11 TECO V34 (soon to be available from DECUS) supports 
user initialization via a file called TECO. INI. The TECO 
commands in this file will be executed before TECO starts up. 

Q14. by J-. M. "Pete" Asensio 

As newcomers to TECO, we find it somewhat difficult to 
decipher involved programs, such as the scope macros, when 
no comments are present in the distributed version. Is it 
possible to obtain a commented listing of VT52.TEC or 
VTEDIT.TEC? We wish to patch these macros for use with 
non-DEC terminals, specifically the Infoton 1-100 . 

A14. no answer supplied. The authors were "too engrossed" in 
getting this marvel to work that they didn't bother to 
include any comments. Anyone who has commented it should 
send us a copy. We hope that other readers who send us 
useful TECO. programs will properly comment them. 

Q15. by Nick Carr (DEC Europe) 

My main use. of TECO is with RSTS/E. Unfortunately, these 
scope macros run rather slowly with RSTS/E. It is possible 
to type ahead several characters (apparently between run 
bursts) and then TECO will suddenly catch up. Would it be 
feasible to increase the speed of these macros, possibly at 
the expense of some functionality? 

A15. We are always trying to increase the speed of VTEDIT. 

Suggestions for speed improvement are always welcome. If 
the latest version of VTEDIT seems too slow for you, you 
might try switching back to VT52.TEC - it should run faster 
but has considerably less functionality. It is always 
possible for you to go through VTEDIT removing features that 
you don't want. You can also shuffle the code around. 
Putting those features that you use most frequently at the 
beginning would speed these features up. 
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Q16. by H. S. Hopkins Jr (General Latex and Chemical Corp. 
of Ohio) 

Let's say I'm in the middle of the third page of a 5 page 
TECO source, and want to bring in (insert) several lines 
or all of another source file. I keep losing 1) the rest of 
the 5 pages, 2) my place in the source, or 3) everything 
except the backup file. Is there a convenient way to make 
this type of insertion? 

A16. If you know in advance that you want to make these insertions, 
you should open the file containing the material to be in- 
serted first . Read the file in, store the material to be 
later inserted into a Q-register, and then begin your edit. 
If you are using TECO-11, another solution is possible (this 
method is not available with OS/8 TECO or TOPS-10 TECO) : 
Store away the current text buffer (HXAHK) , open up the other 
file using a secondary input stream (EPERf ile$Y) , locate 
the material to be inserted and store it away in some Q- 
register, delete the unwanted text and switch back to the 
primary input stream (HKER$GA) and restore the text buffer. 
Then resume your editing. 

Q17. Conversely, I would like to take 15 or 20 lines from page 4 
and put them somewhere on page 2 . How can this be done? 

A17. Some TECO variants allow reading the entire file into memory 
to let you do editing like this. If you don't have such an 
editor, there are several ways : you can proceed. The simplest 
is to move the text into a Q-register, finish your edit 
without leaving TECO, and then do another EB and insert the 
text where desired. Another solution (which only works if 
•you have enough memory and the two pages are near each other) 
is to read several pages into core at once; enough to in- 
clude the two pages in question. When doing this, don't 
forget to re-insert the form feeds that the Append command 
removes when appending pages together. For example, if 
you were on page 2, instead of doing a P when you were done, 
you would issue a AZJ12I$A command. Pages 2, 3, and 4 would 
now be in the text buffer and you would have no trouble 
moving text from page 4 to page 2. Another solution, for 
. longer shuffles, as you say later in your letter, is to break 
the source up into several files, edit these as necessary, 
and then recombine the files in the desired order. 

Q18. by Ray Newman (North Brisbane, Australia) 

We have changed the effect of the CTRL/Z command (in the 
VT52 macro under RSTS/E) to do an EX. Unfortunately, this 
will, if and only if the private default run-time system is 
BASIC,' leave the terminal with the echo turned off. How can 
we get around this problem? 

A18. This problem has been solved for you in VTEDIT. With that 
macro, you use the ESC CTRL/Z to perform a clean exit. You 
probably could have solved the problem by explicitly turning 
echo back on via the command (-8-1) &ETETEX . 
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L9 by Ian Calhaem (Board member, DECUS Australia) 

X ha ve made edifications to W52.TEC (£^11-^ 
RT-11 V3) to enable use with a VTIPP. »« command 
Sat a RESET escape sequenc e^s output^f terj^ ^ 
EX$$ ? How can I convert: rrum ow 
reverse? 
19 . Get and use VTEDIT when it becomes available, ^g," 
expanded version of VT52 which ^ P^,. VT10 
This macro supports ^ 32 ° ^"" r . cut buffer' in 

features (for exam P le ' ^,4 £?na instead of going back to 
reverse video. To quit editing, -»f teaa y ESC y CTRIl / Z 

' TEC ° ^ t o S VTESlT an VTEoTthtn sends^'proper escape 
^encef JoTour " teSal (if it is < . VT1 W to put it 
back in a nice mode, and then exits TECO. 

same time. • 

„=,=„ t-o aet TECO to run in the foreground 
A20. Yes. It is very easy to ge t TECO togethe r the 
under RT-11. All yo u ha ve t ° QBJ) using the 
object modules (TECO. OBJ an ^ ™ ^ " ,' ci£y a 100-word 
/FOREGROUND switch *%*£«£& caTbe^un in the 
foSrounrvifthe'.ERO,, nCOca^^Jg Bramhall^ 

reports that there «f^°™ e p ^ e ms with running TECO in 
for RT-11 which might cause prob lemo f .^ . _ 
the foreground. ?;11 theseD u |* d under v34 is even 

In f » ct ' rHo re-linking necessary r a prelinked 
simpler, since no re nuu y _„ rn kit 
TECO.REL is included in the V34 TECO kit. 

Q21 by Ray Newman (North Brisbane, Australia) 

'under RSTS/E, two of the internal^ ^^^^e^ofnot!^ 
ways depending on wh ^her the user i| P« ^ both for 
• scope terminals the ET flag and the *u y e flags 

' rare P treir e ro d rrert r v;iu F e°s! ^ow^we get around this, 
A21 you are -ing an old version of TECO.^This^blem ha^ 

^recTeL^orRSTS ^^^^J^l^^^ 
Use that version, or use V34 wnen 
the DECUS library. 

Q22 by Stanley Rabinowitz, DEC Merrimack 

What is the origin and derivation of the term "Q-register"? 
A22. No answer supplied. Responses are Solicited. 
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THE SEWERS OF PIING POONG ■ 

Ned Freed has written in to tell us about the many TECO programs 
that he has. These were written for TEXAS TECO version 
124(344) . I hope that he will submit them to the DECUS program 
library. In the mean time,, he will send them to anyone who sends 
him a magtape. The two he sent to me were too big to print. 
One, called TECINI, was 4 solid pages. of TECO code and is a 
utility to allow quick construction of good TECO. INI files. 
It allows TECO novices to have very sophisticated macros at their 
disposal, and for experts to generate them more quickly. 
The other program is called SEWER. It was originally written 
by Darryl Morrell and modified by Charles Carvalho. I was quite 
impressed by this game. It is a mini-ADVENTTJRE and was almost 
5 pages long, including such informative messages as YOU ARE 
SITTING IN YOUR LITTLE MUD HUT IN PIING POONG EATING YOUR BOWL 
OF RICE WHEN ALL OF A SUDDEN A TYPHOON BLOWS IN. THE RESULTING 
FLOOD WASHES YOU OUT OF YOUR HUT AND INTO . . . THE SEWERS OF 
PIING POONG, and YOU ARE IN AN ANCIENT CATACOOMB WITH PILES OF 
BONES EVERYWHERE. A LARGE VAULTED PASSAGE WEST IS NOW BLOCKED 
BY A CAVE- IN. THERE IS A SMALL HOLE IN THE EAST WALL. THE 
SKELETONS ARE WEARING VARIOUS PIECES OF JEWELRY, ..., and 

YOU ARE ON THE SOUTH EDGE OF A STREAM OF SLUDGE 

The object is to get out of the sewers. 
Ned's address is: 

Ned Freed 

Seaver Computer Center 

The Claremont Colleges 

Claremont, CA 91711 



HELP PROGRAM FOR RSTS/E 

Ray Newman (of North Brisbane, Australia) sent along- the 
program HELP. TEC (printed on the next page). This program 
responds to the RSTS/E CCL command HELP. If there is no 
following argument, it lists topics for which help is available. 
Arguments that follow the command are used to select information 
from one of two help files and display it on a VT52. It first 
searches the users PPN for the file HELP.HLP. If if fails to 
find it there, it searches [1,2]. The format of the file is: 
One topic per page and all topics and sub-topics enclosed in 
matched braces. Ray says he is indebted to RT11 for the idea, 
but not the code which is of the home-grown variety. 
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HELP. TEC 



Res ponder to the HELP CCL !" * 

Set up the. various Q re£s ! 
@~US\UT ET*1ET 27 "T QT"T ETS < t'\„ >ET\ 

cmjcvox 

C-TUZXZJ ZUi GA QlJ l(?S/ / 

»T Q1».~IXB **ZXA Q1*ZK ' ♦ V 
0U8 0U9 -1EU ~1"X e^UE/ 

/ @EW// G* 
! Close off command file ! 

• " and check for correct CCL ! 
@EI// J ::&S/HELP/"F'@~A/?Illesf3l CCL command 

/ "C 

! Clean up and store command ! 

Or *K ' S D ZJ J?I/ /J , 

!REM! ::t?B/"ES/ B T -D ©0 ! REM ! ' 

< @S/ /? DJ > HXA HXD HK 

! Try for private help file ! 

! if that fails s5o straight ! 

! to the system file CI r 21 ! 

;@ER/HELP*HLP/ "F 

ISYSFIL! CD J A 1U9 

jeER/Clf23HELP»HLP/ "F GTA/ 

TNo help file available 

/ "C ' ' Y 

! Check for command if none ! 

! then Just list topics ! 

US "N C0!TC! ' HZ "E GTA/ 

Help is available for the -following topics* 

/ 

0U1 !TC! < J D @S/"S/ Br«-1T ♦ ~1,%l-60 "G GTA/ 

/ 0U1 ' < --CQ1S15)* GTA/ / 1%1 > "N"\..J Y > 

Q9 "E 1U8 eCMSYSFIL! ' £~*A/ 

/Q? ' ~C ' 

! The main loop starts here ! 

OIU < OJ < IARRGH? -rx- QS/</t 

+ U2 1U4 < !©S/"EGC/ °F 8* A/ 

TCorrupt HELP*HLP file 

/ T ' 1%4 0~1A --125«E 0-2%4 »E ♦ U3 @0!C0NT! ' ' > 

ICONT! Q2J 0'"X X i eS/^EQD/ B T eS/~S/ Q2»,"1-JXE i@~UE/ / 

MZ "N 03-l>ZK B»G2K J (Mi ! ARRGH ! ' 

Q3-ifZK B>Q2K 

ITYPE IT ! J < ©S/~EGC/? ■ D >!# ET&512 * ! 1 " N 72MS 74MS 91MS 
J BE GTA/ 

/ ET&512 l-IT GTA/ 

/!#ETSS12*!1 "N 92MS ' "C ' Q2J Gl " E Q3J '.> 

"N"V.-v Y > Q9 "E (?0!SYSFIL» ■ ' GTA/ 
%No help for / JGD (?~A/ 
/ T $$ 



SQU* TEC • the TECO macro squisher 
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SQU.TEC • -the TECO macro squisher 



Mark Bramhel 1 



This macro 
80 tHat it 



wil 1 take a 
1s as small 



nice, readable 
and as fast as 



TECO-ll macro and squish It 

n* H *»H*ki^ omi i ,j J - — -- Possible (and is completely 
unreadable), SQU is distributed with the TECO-M " 

any operating system that supports TECG- 



run under 

You invoke SQU with the MUNG 



kit 
11. 



and wi 1 1 



commsndi For examples 



MUNG SOU 



responses enclosed in 
vou Just type RETURN in 
below the term "lexical " 



SOU then enters into a dialogue with you as described below am 

questions contain the allowed legal °* SCMD * a below. All 

parentheses and the default you get if 

angle brackets, ' In the discussion 

refers to characters that TECO would have interpreted as TECO 

commands? all characters inside string arguments 

characters. For example, the ABC of SA8C$ 

the S an.d S are. Similarly, the ABC and DEF of 
not lexical while the #, F, S, /'a, and $ are. 



characters while 
•FS/ABC/DEF/ are 



are not 
are not 



lexical 
lexical 



Delete CR/LF CY/N) <N>? 

AY response will delete all lexical RETURNS and LINE FEEDs. 

su^steT iut P ! iUl J: <n ° ne , mv ,0nfl HH ^"' ananswlr o N 
suggested Cbut, see the question below). 



As 
is 



Set 1 ine lengths (Y for 70, 
asked i f 



N# or length) <N>? 



Thi s question i e 

question. If a 

delete al 1 lexical 

CR/LF combination wherever 

than th$ 1 engt h spec i f i ed, 



you responded N to the previous 
positive response i s gi ven r SQU wi 1 1 initially 
CR/LFs, then, as a oostworccess, insert 



it's 



the 



This 



needed so that no line is longer 

..... tk« «.. fc , neatly formats the squished TECO 
macro, The most commonly used length is 70 
length of 70. 



results in a 



•o a response of Y 



Delete blank lines CY/N) «N>? 



This question is 
questions above, 
being deleted. 



asked only if 
A Y answer 



you responded N to both of the 
results in all lexical blank lines' 



Delete lexical TABs and FORM FEEDs CY/N) <N>? 



st V artran Q Ini^ F ° RH FEED$ haVe meen ^ ** TEC0 CUB 

starts an insert* FORM FEED outputs a FORM 

»ome TECO macro writers use them simply 

code. Of courser their macros won't 

removing those lexical TABs and FFs. A y response will delete 

all lexical TABs and FORM FEEDs. If your macro aeiete 

you certainly want to answer N, 



FEED on. the terminal ) , 
to format their macro 
correctly execute without 

del ete 
runs unsquishedp 



Delete comments CY for SP/TAB, N, or set) <N>? 



5LQU.TEC - the TECO macro iquliher 
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labels (tags) use the 




Watch progress (Y/n) <n>? 



If your terminal Is supported by the 
this question will ** asked. At 
.llllv? you can watch Its progress, 
for production aqulshlng,.. 



W (scope watch) commands* 
the cost of SQU running more 
Useful for debugging* not 



Automatic mode CY for %, N;, or set) <H>1 



This 



the most 



confusing Question. 
'♦» touch characters 



The problem here 
1na1 de string 



1s that 
a rgurcent 




aets the 

may enter 



.(.»_»<»»*» H X M la to be used for ,,. DQna . 

character * v* ; Th»i»»fore» a Y response 

asriuSfflr-S':..- : -«- j« ::.u,.. , :"«., .. .« 

of eh«r«cter(»> vou -ant. r , , ltih , 

-U »tr1no delimited dv a P"". 




TKe 



Allow edjaeent ESC.Pe. CY/N) <N>? 

can resul t 
*t before, 
turn 



macro 



process of squishing l 
ESC.oe eh.r.eter. wH.r.^K.re^w.en^ 



commend #FS/ABC// ««» p ^ d ' v , 8 , n ER command, 



the macro will be 
buffer* copied to a 

•response will direct SQU 



Q»reg1 steri 
other hand* 



and 
1 f the 



in two adj acent 

For example. If the 

Into FSABCSS. I* 

yanked Into the text 

executed tMt poses 

1a to be EI'd, 



1t 



mac ro 



command execution p^^^^^; 
to never generate adjacent ts 



no 

t he 

An 

Capes 
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File '<*,TEC>? 



SQU 1s now asking 
macro and Indie 
After your reply* 



macro. 
You can 



you for the file spec! f Teat 1 an of your TECO 
ting the it will default the extension to ,TEC« 
SQU will take off and st&ft squishing the 
When It's doner It will simply return l ■:. TECo's * prompt, 
now write out the squished macro however you want. 



If you Invoke SOU as 

MUNG SQU,f 1 lnam 

It will enter Its dialogue for the squishing options* but will 
start squishing Immediately after asking about adjacent ESCap.es 
then return to the * prompts 



You can Invoke 
switches. The 

/0 
/L 

/e 

/T 

/c 

/w r 

/A 

/E 



SOU *peci fylng all 
sw Itches ares ' 



of the squishing options as 



Delete CR/IF 
Set 11 ne 1 engths 
Del ete bl ank 1 1 nes 
Delete lexical TAB/FFs 
Del ete comments 
Watch progress 
Automatic mode 
Allow adjacent ESCapes 



switch should be expressed as /xsy where H x M Is the switch 
H y M 1s either Y or N, 



Each 

and H y M 1s either Y or N, A non*standard line length can be 
expressed as /Linn where "nn" 1s some non»zero digit string, 
Non-standard character sets can be specified for the /C and /A 
switches* but the character set Is limited to a single character, 
For example* /C8* sets the comment character set to H * M and /As* 
sets the non-squl ahabl e *U command character set to "*•'• 



You can also 
sped f Icat 1 ons, 



suppl y SQU with 
For examples 



both output and Input file 



MUNG SQUfOUtf 1 U1nf 11 



SQU will enter 
Immediately do 



1 ts dialogue for the 
the squ! shlng* write 



squishing options* then will 
out the result* and exit. 



If you have specified everything SQU needs (an Input file* »r\ 
output filer and all of the options as switches)* It will do the 
whole squishing operation and exit without further- Intervention, 
A convention used at DEC (and recommended by the TECO SIG) 1s 
that 1f a TECO macro Is Intended to be squished.'* the unsqulshed 
version be given a ,TES extension CTECO Source) and the squished 
version be given a ,TEC extension, A file with a ,TEC extension 
must always be a runnable TECO macro Cor program). 
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JECO- RELATED DECUS SUBMISSIONS. 

The following items of interest to TECO users are available 
from the DECUS program library: 

Number Description , 

DECUS-8-873 RSTS Terminal Monitor on a PDP-8 

Written by Andras Nagy. This package 
lets you connect together OS/8 and RSTS/E. 
Its goal is to synthesize the powers and 
versatilities of the RSTS and OS/8 
operating systems. The source language 
consists of a, mixture of assembly code 
• - , and TECO macros; / 

DECUS-10-116 QED Written at the University of Utah. 

This is an .implementation of the well- 
known line-oriented editor known as- QED. 
It is written in TECO ^nd runs under a 
slightly modified version of a 1970 copy 
of DEC'S TOPS-10 TECO. ' < •■ r K 

DECUS-10-14 8'1 PDP-11/10 Loader ,' t '^ v ./ ; , 

DECUS-11-53 I Written by H. L. Farhsworth iin<a R. B. Fieisher 

Can be ordered under either number. 
Consists of two TECO programs that allow 
full duplex conversation between TOPS-10 
and a PDP-11 terminal. 'Also lets a PDP-11 
program to be assembled on the -10 and 
loaded directly into' "PDP-11 memory. 

DECUS-11-36J2T RSX TECO with Buffered Typeout and VT 5 2 Window 

Support, plus TECO DOCTOR. Game 

Written by G. Everhart. This consists of 
two parts. The first pajrt is a video 
• editor (for a VT52) written in TECO. . It 

runs under, a modified version of TECO-11 
which is enclosed. \That' version of TECO 
is now obsolete since the latest TECO-11 
for RSX supports VT52s properly. The second 
part of this submission consists of the 
well-known t DOCTOR program (ELIZA) written 
in TECO. It is slightly less powerful than 
, the original LISP program; It allows the 

computer to respond to your statements as 
would a psycho-analyst, arid attempts to 
carry out a conversation with the user. 
Should run under most TECOs. What does 
that suggest to you? 

-DECUS-11-265 DOS-11 TECO 

• Written by Glenn Everhart. It is a copy 
of version 15 of TECO-11 which has been 
interfaced to a new I/O module to allow it 
to run under the DOS-11 operating system. 
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